<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
	<title>API: yahoo  YAHOO   (YUI Library)</title>
	<link rel="stylesheet" type="text/css" href="assets/api.css">
    <script type="text/javascript" src="assets/api-js"></script>
    <script type="text/javascript" src="assets/ac-js"></script>
</head>

<body id="yahoo-com">

<div id="doc3" class="yui-t2">

	<div id="hd">
        <a href="http://developer.yahoo.com/yui/"><h1>Yahoo! UI Library</h1></a>
        <h3>YAHOO Global&nbsp; <span class="subtitle">2.3.1</span></h3>
        <p>
        <a href="./index.html">Yahoo! UI Library</a> 
            &gt; <a href="./module_yahoo.html">yahoo</a>
                 &gt; YAHOO 
                
            </p>

	</div>

	<div id="bd">
		<div id="yui-main">
			<div class="yui-b">
            <form name="yui-classopts-form">
    <span id="classopts"><input type="checkbox" name="showprivate" id="showprivate" /> 显示 Private</span>
    <span id="classopts"><input type="checkbox" name="showprotected" id="showprotected" /> 显示 Protected</span>
            </form>

                    <h2>
                        

                        <code>静态（static）</code>
                        
                            类 <b>YAHOO</b>
                        <span class="extends">
                        </span>

                        <span class="extends">
                        </span>
                        
                        </code>
                    </h2>
                    <!-- class tree goes here -->
                    
                
  

                    <div class="summary description">
                        YAHOO 是全局命名空间对象。如果 YAHOO 已经被定义，现有的 YAHOO 对象将会被重写，所以该定义的命名空间应受到保护。 
                    </div>




                        <div class="section method details">
                            <h3 id="methods">方法</h3>
                            <div class="content">
                                    <div class="">
                                    <h4>
                                        <a name="augment">增加（augment）</a></h4>
                                    <div class="detail">
                                        <code>
                                        
                                         static 
                                        
                                        void
                                            <strong>augment</strong>
                                           (
                                                
                                                        
                                                         r
                                                    
                                                
                                                        , 
                                                         s
                                                    
                                                
                                                        , 
                                                         arguments
                                                    
                                                
                                            )
                                        </code>
                                        
                                        <div class="description">
                                            别名：<a href="YAHOO.lang.html#augment">YAHOO.lang.augment</a>
                                        </div>

                                        <div class="description">

                                                <dl>
                                                    <dt>参数：</dt>
                                                        <dd>
                                                            <code>r &lt;Function&gt;</code>
                                                              用来接受增加的对象
                                                        </dd>
                                                        <dd>
                                                            <code>s &lt;Function&gt;</code>
                                                              用来增加的对象，该对象提供属性
                                                        </dd>
                                                        <dd>
                                                            <code>arguments &lt;String*&gt;</code>
                                                             0个或者更多的属性方法增加给接受对象。如果没有被指定，提供对象的任何属性都可使用，除非在接受对象中，它重写一个现有的属性。
                                                        </dd>
                                                </dl>

                                                <dl>
                                                    <dt>返回：
                                                    <code>
                                                        void
                                                    </code></dt>
                                                    <dd></dd>
                                                </dl>
             
                                        </div>

                                    </div>
                                    <hr />
                                    </div>
                                    <div class="">
                                    <h4>
                                        <a name="extend">扩展（extend）</a></h4>
                                    <div class="detail">
                                        <code>
                                        
                                         static 
                                        
                                        void
                                            <strong>extend</strong>
                                           (
                                                
                                                        
                                                         subc
                                                    
                                                
                                                        , 
                                                         superc
                                                    
                                                
                                                        , 
                                                         overrides
                                                    
                                                
                                            )
                                        </code>
                                        
                                        <div class="description">
                                            别名： <a href="YAHOO.lang.html#extend">YAHOO.lang.extend</a>
                                        </div>

                                        <div class="description">

                                                <dl>
                                                    <dt>参数：</dt>
                                                        <dd>
                                                            <code>subc &lt;Function&gt;</code>
                                                             用来修改的对象
                                                        </dd>
                                                        <dd>
                                                            <code>superc &lt;Function&gt;</code>
                                                             用来继承的对象
                                                        </dd>
                                                        <dd>
                                                            <code>overrides &lt;Object&gt;</code>
                                                             添加额外的属性或方法到子类的原型上。这些将重写从存在的超类获得的匹配类目。
                                                        </dd>
                                                </dl>

                                                <dl>
                                                    <dt>返回：
                                                    <code>
                                                        void
                                                    </code></dt>
                                                    <dd></dd>
                                                </dl>
             
                                        </div>

                                    </div>
                                    <hr />
                                    </div>
                                    <div class="">
                                    <h4>
                                        <a name="log">记录（log）</a></h4>
                                    <div class="detail">
                                        <code>
                                        
                                         static 
                                        
                                        Boolean
                                            <strong>log</strong>
                                           (
                                                
                                                        
                                                         msg
                                                    
                                                
                                                        , 
                                                         cat
                                                    
                                                
                                                        , 
                                                         src
                                                    
                                                
                                            )
                                        </code>
                                        
                                        <div class="description">
                                            如果 widget 是可用的，使用 YAHOO.widget.Logger 则将输出一个记录消息。
                                        </div>

                                        <div class="description">

                                                <dl>
                                                    <dt>参数：</dt>
                                                        <dd>
                                                            <code>msg &lt;String&gt;</code>
                                                              用于记录的消息。
                                                        </dd>
                                                        <dd>
                                                            <code>cat &lt;String&gt;</code>
                                                              消息的记录类型。缺省的类型有“info”，“warn”，“error”，“time”。自定义的类型也可以使用。（可选的）
                                                        </dd>
                                                        <dd>
                                                            <code>src &lt;String&gt;</code>
                                                              消息的来源。（可选的）
                                                        </dd>
                                                </dl>

                                                <dl>
                                                    <dt>返回：
                                                    <code>
                                                        布尔值（Boolean）
                                                    </code></dt>
                                                    <dd>如果记录的操作成功，则返回 True 。</dd>
                                                </dl>
             
                                        </div>

                                    </div>
                                    <hr />
                                    </div>
                                    <div class="">
                                    <h4>
                                        <a name="namespace">命名空间（namespace）</a></h4>
                                    <div class="detail">
                                        <code>
                                        
                                         static 
                                        
                                        Object
                                            <strong>namespace</strong>
                                           (
                                                
                                                        
                                                         arguments
                                                    
                                                
                                            )
                                        </code>
                                        
                                        <div class="description">
                                            返回指定的命名空间，如果它不存在则创建命名空间。
<pre>
YAHOO.namespace("property.package");
YAHOO.namespace("YAHOO.property.package");
</pre>
上面的任何一个都将创建 YAHOO.property ，然后 YAHOO.property.package 。当命名程序包时，需要注意。保留字可以在一部分浏览器中有效，而其他浏览器中则无效。 例如，下面的内容将会在 Safari 中失效：
<pre>
YAHOO.namespace("really.long.nested.namespace");
</pre>
失败的原因为在 ECMAScript 中 "long" 是一个将来的保留字。
                                        </div>

                                        <div class="description">

                                                <dl>
                                                    <dt>参数：</dt>
                                                        <dd>
                                                            <code>arguments &lt;String*&gt;</code>
                                                             用于创建的 1-n 个命名空间。
                                                        </dd>
                                                </dl>

                                                <dl>
                                                    <dt>返回：
                                                    <code>
                                                        Object
                                                    </code></dt>
                                                    <dd>最后被创建的命名空间对象的引用。</dd>
                                                </dl>
             
                                        </div>

                                    </div>
                                    <hr />
                                    </div>
                                    <div class="">
                                    <h4>
                                        <a name="register">注册（register）</a></h4>
                                    <div class="detail">
                                        <code>
                                        
                                         static 
                                        
                                        void
                                            <strong>register</strong>
                                           (
                                                
                                                        
                                                         name
                                                    
                                                
                                                        , 
                                                         mainClass
                                                    
                                                
                                                        , 
                                                         data
                                                    
                                                
                                            )
                                        </code>
                                        
                                        <div class="description">
                                            为 YAHOO 对象注册一个模块。
                                        </div>

                                        <div class="description">

                                                <dl>
                                                    <dt>参数：</dt>
                                                        <dd>
                                                            <code>name &lt;String&gt;</code>
                                                                模块的名字（事件，滑块，等等）
                                                        </dd>
                                                        <dd>
                                                            <code>mainClass &lt;Function&gt;</code>
                                                                 模块中类的引用。这个类将绑定版本信息，所以，当若干版本加载时，它将可能识别使用中的版本。
                                                        </dd>
                                                        <dd>
                                                            <code>data &lt;Object&gt;</code>
                                                                  模块的元数据对象。通常期望它至少包含一个“version”属性和一个“build”属性。
                                                        </dd>
                                                </dl>

                                                <dl>
                                                    <dt>Returns:
                                                    <code>
                                                        void
                                                    </code></dt>
                                                    <dd></dd>
                                                </dl>
             
                                        </div>

                                    </div>
                                    <hr />
                                    </div>
                            </div>
                        </div>







			</div>
		</div>
		<div class="yui-b">
            <div class="nav">

                    <div class="module">
                        <h4>Modules</h4>
                        <ul class="content">

                                <li class=""><a href="module_animation.html">animation</a></li>

                                <li class=""><a href="module_autocomplete.html">autocomplete</a></li>

                                <li class=""><a href="module_button.html">button</a></li>

                                <li class=""><a href="module_calendar.html">calendar</a></li>

                                <li class=""><a href="module_colorpicker.html">colorpicker</a></li>

                                <li class=""><a href="module_connection.html">connection</a></li>

                                <li class=""><a href="module_container.html">container</a></li>

                                <li class=""><a href="module_datasource.html">datasource</a></li>

                                <li class=""><a href="module_datatable.html">datatable</a></li>

                                <li class=""><a href="module_dom.html">dom</a></li>

                                <li class=""><a href="module_dragdrop.html">dragdrop</a></li>

                                <li class=""><a href="module_editor.html">editor</a></li>

                                <li class=""><a href="module_element.html">element</a></li>

                                <li class=""><a href="module_event.html">event</a></li>

                                <li class=""><a href="module_history.html">history</a></li>

                                <li class=""><a href="module_imageloader.html">imageloader</a></li>

                                <li class=""><a href="module_logger.html">logger</a></li>

                                <li class=""><a href="module_menu.html">menu</a></li>

                                <li class=""><a href="module_slider.html">slider</a></li>

                                <li class=""><a href="module_tabview.html">tabview</a></li>

                                <li class=""><a href="module_treeview.html">treeview</a></li>

                                <li class="selected"><a href="module_yahoo.html">yahoo</a></li>

                                <li class=""><a href="module_yuiloader.html">yuiloader</a></li>

                                <li class=""><a href="module_yuitest.html">yuitest</a></li>
                        </ul>
                    </div>

                    <div class="module">
                        <h4>Classes</h4>
                        <ul class="content">
                                <li class="selected"><a href="YAHOO.html">YAHOO</a></li>
                                <li class=""><a href="YAHOO.env.html">YAHOO.env</a></li>
                                <li class=""><a href="YAHOO.env.ua.html">YAHOO.env.ua</a></li>
                                <li class=""><a href="YAHOO.lang.html">YAHOO.lang</a></li>
                                <li class=""><a href="YAHOO_config.html">YAHOO_config</a></li>
                        </ul>
                    </div>

                    <div class="module">
                        <h4>Files</h4>
                        <ul class="content">        
                                <li class=""><a href="Env.js.html">Env.js</a></li>
                                <li class=""><a href="Lang.js.html">Lang.js</a></li>
                                <li class=""><a href="YAHOO.js.html">YAHOO.js</a></li>
                        </ul>
                    </div>


                    <div class="module">
                        <h4>Methods</h4>
                        <ul class="content">        
                                <li class=""><!--<code>void</code>-->
                                <a href="#augment">augment</a>
                                </li>
                                <li class=""><!--<code>void</code>-->
                                <a href="#extend">extend</a>
                                </li>
                                <li class=""><!--<code>Boolean</code>-->
                                <a href="#log">log</a>
                                </li>
                                <li class=""><!--<code>Object</code>-->
                                <a href="#namespace">namespace</a>
                                </li>
                                <li class=""><!--<code>void</code>-->
                                <a href="#register">register</a>
                                </li>
                        </ul>
                    </div>



            </div>
		</div>
	</div>
	<div id="ft">
        <hr />
        Copyright &copy; 2007 Yahoo! Inc. All rights reserved.
	</div>
</div>
</body>
</html>
